home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / impperror.z / impperror
Text File  |  1998-10-30  |  3KB  |  67 lines
  1.  
  2.  
  3.  
  4. iiiimmmmppppPPPPeeeerrrrrrrroooorrrr((((3333))))                     IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                      iiiimmmmppppPPPPeeeerrrrrrrroooorrrr((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      impPerror, impErrorString - report libimp execution error messages
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<iiiimmmmpppp....hhhh>>>>
  13.  
  14.      vvvvooooiiiidddd iiiimmmmppppPPPPeeeerrrrrrrroooorrrr((((ccccoooonnnnsssstttt cccchhhhaaaarrrr ****ssssttttrrrr))));;;;
  15.  
  16.      cccchhhhaaaarrrr**** iiiimmmmppppEEEErrrrrrrroooorrrrSSSSttttrrrriiiinnnngggg((((iiiinnnntttt eeeerrrrrrrrCCCCooooddddeeee))));;;;
  17.  
  18.      eeeexxxxtttteeeerrrrnnnn iiiinnnntttt IIIIMMMMPPPPeeeerrrrrrrrnnnnoooo;;;;
  19.  
  20. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  21.      _i_m_p_P_e_r_r_o_r prints error messages to _s_t_d_e_r_r in a format similar to the
  22.      standard C library function _p_e_r_r_o_r(_3_C). If an error occurs during a
  23.      _l_i_b_i_m_p function call, the global error variable _I_M_P_e_r_r_n_o will be set with
  24.      an error code.  The error code will either be a system error code (i.e.
  25.      _e_r_r_n_o) or a _l_i_b_i_m_p specific code. The symbolic names for the _l_i_b_i_m_p error
  26.      codes are defined in _i_m_p._h.
  27.  
  28.      The value of _I_M_P_e_r_r_n_o is used by _i_m_p_P_e_r_r_o_r as an index to a table of
  29.      error messages.  _i_m_p_P_e_r_r_o_r will print the user-supplied string _s_t_r
  30.      followed by a colon (:), a space, and the error message corresponding to
  31.      the current value of _I_M_P_e_r_r_n_o. If the string _s_t_r is the NULL string (""),
  32.      no colon or space will be printed, only the error message. The error
  33.      message will either be a system error message or a _l_i_b_i_m_p specific
  34.      message.
  35.  
  36.      To be of most use, a call to _i_m_p_P_e_r_r_o_r should be made immediately
  37.      following the _l_i_b_i_m_p function call where an error has been detected.
  38.  
  39.      _i_m_p_E_r_r_o_r_S_t_r_i_n_g is similar to the _s_t_r_e_r_r_o_r(_3_C) function and returns the
  40.      error message corresponding to the error code specified by _e_r_r_C_o_d_e. If
  41.      _e_r_r_C_o_d_e is less than IIIIMMMMPPPP____EEEERRRRRRRR____BBBBAAAASSSSEEEE, the message returned is a system error
  42.      message generated by _s_t_r_e_r_r_o_r. If _e_r_r_C_o_d_e is one of the error codes
  43.      specified in _i_m_p._h, the returned string is a _l_i_b_i_m_p specific error
  44.      message.
  45.  
  46. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  47.      libimp(3), perror(3C), strerror(3C)
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.